Inside Macintosh: More Macintosh Toolbox /

Chapter 5 - Icon Utilities / Icon Utilities Reference

Icon Utilities Routines / Drawing Icons From Resources

PlotCIconHandle

You can use the PlotCIconHandle function to plot an icon of resource type
'cicn'. You must have previously obtained a handle to the icon using GetCIcon (or GetResource or other Resource Manager routines).

FUNCTION PlotCIconHandle (theRect: Rect; align: IconAlignmentType;
                          transform: IconTransformType; 
                          theCIcon: CIconHandle): OSErr;

theRect

The rectangle in which to draw the icon, specified in local coordinates of the current graphics port.

align

A value that specifies how PlotCIconHandle should align the icon within the rectangle. See the description of PlotIconID on page 5-20 for a list of constants you can use in this parameter.

transform

A value that specifies how PlotCIconHandle should modify the appearance of the icon. See the description of PlotIconID beginning on page 5-20 for a list of constants you can use in this parameter.

theCIcon

A handle to the color icon record of the icon to draw.

DESCRIPTION

The PlotCIconHandle function draws the specified color icon with the transform and alignment specified by the transform and align parameters. Unlike PlotCIcon, PlotCIconHandle doesn't honor the current foreground and background colors.

RESULT CODES

noErr	0	No error
paramErr	-50	Error in parameter list

SEE ALSO

For an example of the use of PlotCIconHandle, see Listing 5-8 on page 5-16. For information on GetCIcon, see page 5-29. For a description of the color icon record, see page 5-17.